home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra_2 / vgscap12.zip / VGSCAP.DOC < prev    next >
Text File  |  1995-10-23  |  16KB  |  414 lines
  1.  
  2.  
  3. VGSCAP - v1.2
  4.  
  5. VGA screen capture
  6.  
  7.  
  8. General Information
  9.  
  10. (C) 1994 Bernard Voedts - All rights reserved
  11.  
  12.  
  13.  
  14.     DESCRIPTION
  15.     ___________
  16.  
  17.     VGSCAP is a resident program (TSR) enabling the user to capture pictures
  18.     or texts appearing on a VGA or SVGA display.
  19.     Its installation mode makes possible to do the capture, whatever
  20.     the currently running program (especially if it is a game),
  21.     by pressing a key on the keyboard or the right button of the mouse.
  22.  
  23.     A "Pause" function allows to do the capture at a precise moment.
  24.     The capture is possible under Windows 3.1, directly in the Standard mode,
  25.     indirectly in the 386 Enhanced mode.
  26.  
  27.  
  28.     LIMITED WARRANTY
  29.     ----------------
  30.  
  31.     The software is supplied "as is" with no warranty of any kind,
  32.     explicit or implicit.
  33.     In no event can the author be considered as responsible for any damages
  34.     resulting from using the software, any risk being assumed by the user.
  35.  
  36.  
  37.     SYSTEM REQUIREMENTS
  38.     -------------------
  39.  
  40.     PC/AT & Compatible.
  41.     VGA controller or SVGA register-level compatible.
  42.     DOS 3.1 or higher.
  43.  
  44.  
  45.     CONTENTS OF THE SUPPLY
  46.     ----------------------
  47.  
  48.     After uncompressing data (if necessary), the supply must contain
  49.     the following files :
  50.  
  51.     - VGSCAP.EXE    Captures VGA or SVGA pictures
  52.     - VGSCAP.DOC    The documentation (the current text)
  53.     - VGSCAP.TXT    Order form
  54.     - WINCAP.EXE    Captures under Windows
  55.     - WCAPDLL.DLL   DLL used by the WINCAP.EXE
  56.     - VIEWVGS.EXE   Visualizes captured pictures
  57.     - VGS2TXT.EXE   Converts a .VGS file into a .TXT file
  58.     - VGS2GIF.EXE   Converts a .VGS file into a .GIF file
  59.     - VGS2PCX.EXE   Converts a .VGS file into a .PCX file
  60.     - VGS2BMP.EXE   Converts a .VGS file into a .BMP file
  61.  
  62.     (the shareware version does not allow SVGA screen capture,
  63.     neither does it allow captures using the mouse)
  64.  
  65.     The full version, available after registration, contains all same files
  66.     lightened of the messages and peculiarities of the shareware version.
  67.  
  68.  
  69.     LICENSE
  70.     -------
  71.  
  72.     VGSCAP is SHAREWARE and may be freely distributed.
  73.  
  74.     You may try it is freely and decide whether it suits your needs
  75.     and works correctly in your environment. After this testing period
  76.     you are in full knowledge for deciding to acquire the license.
  77.  
  78.     For your registration, you can print the VGSCAP.TXT file, fill in it,
  79.     join you payment of US $40 (or equivalent) in check or cash,
  80.     and sent it to
  81.  
  82.     Bernard VOEDTS
  83.     4 rue Michelet
  84.     92130  ISSY-LES-MOULINEAUX
  85.     FRANCE
  86.  
  87.     Registering will make you receive the full version on a 3.5" diskette.
  88.  
  89.  
  90.     INSTRUCTIONS FOR USE
  91.     --------------------
  92.  
  93.     1) VGSCAP
  94.     ---------
  95.  
  96.     Features :
  97.  
  98.         VGSCAP is a resident program enabling pictures capture from a VGA
  99.         or SVGA display. It requires 12 Kb of RAM and loads itself inside
  100.         High Memory, using only 256 bytes of conventional memory.
  101.  
  102.         VGSCAP must be launched from DOS.
  103.  
  104.         The capture is possible for all modes compatibles with a standard VGA
  105.         card, including the most unused modes (for example : text 80x28,
  106.         graphic 720x400 16 colors, 360x480 256 colors ...).
  107.         In VGA mode, the capture does not use the BIOS but operates directly
  108.         with the registers of the card.
  109.         The capture is also possible for the SuperVGA modes compatible with
  110.         the VESA norm :
  111.         - text 80x60, 132x25, 132x43, 132x50, 132x60
  112.         - graphic 16 colors 800x600, 1024x768, 1280x1024
  113.         - graphic 256 colors 640x400, 640x480, 800x600, 1024x768, 1280x1024
  114.         In this mode the capture uses the VESA BIOS, the card must consequently
  115.         use a BIOS compatible with this norm.
  116.         (for old cards, VESA drivers are available in the public domain
  117.         or as sharewares).
  118.  
  119.         It is better to install VGSCAP after the other resident programs.
  120.         One should especially avoid to install it before a resident
  121.         VESA driver, otherwise the VESA driver would be ignored.
  122.  
  123.         The program watch out if 2 specific keys ("Hot-Keys") are activated
  124.         - KEY1 (default value : 'F11' key) launches the capture directly
  125.         - KEY2 (default value : 'F12' key) stops/resumes the current program
  126.             After the KEY2 stop :
  127.             'C' key launches the capture then resumes the intercepted program
  128.             'B' key reboots the machine
  129.             Any key other than 'C', 'B' and KEY2 blackens the screen, after
  130.             which only KEY2 allows the resumption of the intercepted program.
  131.  
  132.         The capture causes the display blinking shortly at the beginning
  133.         and at the end of the process. In the meanwhile, a file with extension
  134.         .VGS is created on the hard disk, it contains the captured picture.
  135.  
  136.         In the shareware version, launching VGSCAP causes the writing of
  137.         VGSCAP.DOC and VGSCAP.TXT.
  138.  
  139.     Syntax : VGSCAP /on|off [parameters] [options]
  140.  
  141.     Parameters :
  142.  
  143.     /on         :   installs the program as resident
  144.  
  145.     /off        :   uninstalls the program
  146.  
  147.     Options :   
  148.  
  149.     /clock
  150.         Causes external clock being reprogrammed at the end of the capture.
  151.         You should try this option with some games (for example :
  152.         Oh No ! More Lemmings) if the system hangs after resuming.
  153.  
  154.     /nopic
  155.         Switches PIC reprogrammation off. As default, VGSCAP reprograms
  156.         the PIC (Programmable Interrupt Controller) when installing itself.
  157.         Switching PIC reprogrammation off gives priority to VGSCAP over
  158.         the intercepted program as far as keyboard interrupt is concerned.
  159.  
  160.     /mouseright=1
  161.         or
  162.     /mouseright=2
  163.         Makes the right button of the mouse replace KEY1 or KEY2.
  164.         Furthermore, after an interception by KEY2 (keyboard or mouse),
  165.         hitting left button launches the capture, while right button
  166.         resumes the intercepted program.
  167.         Warning : with some mouse drivers, it is necessary to move the mouse
  168.         slightly between the hits.
  169.  
  170.         This option is to be used conjointly with /nopic if default
  171.         installation does not allow VGSCAP activation or hinders running
  172.         a program (this may happen with DOS Extenders). Example :
  173.             VGSCAP /ON /NOPIC /MOUSERIGHT=1
  174.  
  175.         This option is not available in the shareware version.
  176.  
  177.     /nomouse
  178.         Makes hardware mouse cursor vanish while activation.
  179.  
  180.     /dma
  181.         Closes the DMA channel specified during activation, in order
  182.         to avoid desynchronization with a sound card.
  183.         Two parameters can be specified : one for low channels (0,1,3),
  184.         the other for high channels (5, 6, 7). Example :
  185.             VGSCAP /ON /DMA1 /DMA7
  186.         Note : sound cards usually utilize channel 1.
  187.  
  188.     /k1=nnn
  189.         Specifies a keyboard code for KEY1.
  190.         Default value is 87 (F11 key).
  191.         (a list of keyboard is available as appendix).
  192.  
  193.     /k2=nnn
  194.         Specifies a keyboard code for KEY2.
  195.         Default value is 88 (F12 key).
  196.  
  197.     /name=[path\]xxxxx
  198.         Specifies a prefix (of 5 characters or fewer) for the names of
  199.         the files containing the captured pictures. The remaining 3 characters
  200.         will be 000, 001, 002 ... 999.
  201.         Full names will be xxxxx000.vgs, xxxxx001.vgs, xxxxx002.vgs, ...
  202.         Default value of the prefix is : vgs.
  203.  
  204.     Examples : VGSCAP /on /name=c:\vgs\
  205.                 Files vgs001.vgs, vgs002.vgs ... will be created in directory
  206.                 c:\vgs (this directory must exist before activation).
  207.  
  208.                 VGSCAP /on /name=toto
  209.                 Files toto001.vgs, toto002.vgs ... will be created in current
  210.                 directory.
  211.  
  212.  
  213.     2) WINCAP
  214.     ---------
  215.  
  216.     Features :
  217.  
  218.         WINCAP is a Windows program which diverts keyboard messages
  219.         and provides the same functions as VGSCAP under Windows.
  220.  
  221.         VGSCAP must be installed under DOS before running Windows.
  222.         WINCAP can be used only with 386-Enhanced mode under Windows.
  223.         WCAPDLL.DLL needs to be accessed by windows.
  224.  
  225.     Installation :
  226.  
  227.         Run WINCAP.EXE and activate the 'Install' menu.
  228.         Quit WINCAP, capturing is now possible.
  229.  
  230.  
  231.     Uninstalling :
  232.         Run WINCAP.EXE and activate the 'Uninstall' menu.
  233.         Quit WINCAP.
  234.  
  235.  
  236.     3) VIEWVGS
  237.     ----------
  238.  
  239.     Features :
  240.  
  241.         VIEWVGS is a program for visualizing .VGS files resulting from
  242.         the captures.
  243.         Its use in the interactive mode makes possible to delete or rename
  244.         the files after visualizing them. 
  245.         In batch mode, one can scroll through the files using the keys
  246.         HOME, END, PGUP, PGDOWN.
  247.  
  248.     Syntax :
  249.  
  250.     VIEWVGS                                 Use in interactive mode
  251.       or
  252.     VIEWVGS file1 file2 ... [/n] [/auto]    Use in batch mode
  253.     VIEWVGS @file [/n] [/auto]
  254.             /n  time of visualization in seconds
  255.             /auto   must be used conjointly with /n, at the end of
  256.                     the file list, loops the loop on the first file
  257.  
  258.     Example :   VIEWVGS C:\VGS\*.VGS /2
  259.                 Displays automatically the selected files every 2 seconds.
  260.  
  261.                 VIEWVGS @vgsflist
  262.                 Displays automatically the files the names of which are listed
  263.                 in the file 'vgsflist'.
  264.  
  265.  
  266.     4) VGS2TXT
  267.     ----------
  268.  
  269.     Features :
  270.  
  271.         VGS2TXT converts .VGS files resulting from captures in text mode
  272.         into files using monochrome ASCII, GIF, or PCX formats.
  273.  
  274.     Syntax : VGS2TXT file1 file2 ... [parameters]
  275.  
  276.     Parameters :
  277.  
  278.     none    :   converts into a .TXT file  (ASCII).
  279.  
  280.     /C      :   converts into a .TXT file with screen outlines.
  281.  
  282.     /G      :   converts into a monochrome .GIF file.
  283.  
  284.     /P      :   converts into a monochrome .PCX file.
  285.  
  286.  
  287.     5) VGS2GIF - VGS2PCX - VGS2BMP
  288.     ------------------------------
  289.  
  290.     Features :
  291.  
  292.         VGS2GIF, VGS2PCX and VGS2BMP convert .VGS files into
  293.         .GIF, .PCX or .BMP formats.
  294.  
  295.     Syntax :    VGS2GIF file1 file2 ...
  296.                 VGS2PCX file1 file2 ...
  297.                 VGS2BMP file1 file2 ...
  298.  
  299.     Example :   VGS2GIF C:\vgs\*.vgs
  300.  
  301.     Note : The shareware version of VGS2GIF, VGS2PCX and VGS2BMP does not
  302.            allow conversion of files .VGS resulting from captures in VESA mode.
  303.  
  304.  
  305.     COMPATIBILITY
  306.     -------------
  307.  
  308.     1) DOS
  309.     ------
  310.         VGSCAP was tested successfully with several hundreds of programs
  311.         (games and others).
  312.         However, like any resident program, compatibility with the currently
  313.         running program or with other resident programs (for example,
  314.         network managers) is never 100% ensured, some hangings or
  315.         malfunctionments may always occur.
  316.         Consequently we recommend using VGSCAP only with strictly necessary
  317.         residents.
  318.  
  319.     2) Protected mode
  320.     -----------------
  321.         VGSCAP runs with Windows 3.1 (not Windows 3.0) in standard mode
  322.         and with several DOS extenders.
  323.  
  324.         Compatibility usually depends on presence or absence of a
  325.         memory manager (EMM386.EXE) in the CONFIG.SYS file.
  326.         It is advisable to test each configuration.
  327.         We have tested the following DOS extenders :
  328.             - DOS/4G (used by DOOM and most of recent games) :
  329.                 VGSCAP requires the absence of EMM386.
  330.             - GO32 (with GNU C/C++) :
  331.                 VGSCAP requires the presence of EMM386.
  332.             - DOSX (with Symantec C++) :
  333.                 VGSCAP works.
  334.             - RTM (with Borland C++) :
  335.                 VGSCAP works.
  336.             - PHAR LAP 286 (tested with PHAR LAP 286 Lite) :
  337.                 VGSCAP works.
  338.  
  339.         The option /nopic /mouseright works with all software above whatever
  340.         the configuration, as well as all DOS Extenders which do not allow to
  341.         capture via the keyboard. Examples :
  342.             - Super-VGA Harrier (game of Domark)
  343.             - Zone66 (shareware game of Epic)
  344.  
  345.         Note : Option /mouseright= is available only in registered version.
  346.  
  347.  
  348.     3) VESA
  349.     -------
  350.         The captures in VESA mode were tested with Windows 3.1,
  351.         with several graphic viewers, and with some games
  352.         (Flight Simulator 5, Battle Chess 4000, Super-VGA Harrier ...)
  353.  
  354.         Some SVGA cards incorporate a VESA interface which does not function
  355.         correctly when a program operates directly with the registers.
  356.         In such cases, activating VGSCAP (which uses the VESA interface)
  357.         may cause the system hanging.
  358.         Such situations may occur :
  359.         - under Windows (because the drivers do not use the VESA interface)
  360.         - under Flight Simulator (if the card is not declared as VESA
  361.           in the setup)
  362.  
  363.  
  364.     4) LOADING IN HIGH MEMORY
  365.     -------------------------
  366.         Faced with a memory manager (EMM386, 386MAX, QEMM ...),
  367.         VGSCAP loads itself in the High Memory if it finds a free block
  368.         of 12Kb, then it occupies only 256 bytes of low memory.
  369.         You must not try to load it "manually" with the LODHIGH command of DOS,
  370.         because its memory requirements would then be greater than 12Kb.
  371.         It is still possible to force the loading in low memory thanks
  372.         to the option /noup. Example : VGSCAP /ON /NOUP
  373.  
  374.  
  375.     APPENDIX : List of Keyboard codes for a 101-Key US Keyboard
  376.     -----------------------------------------------------------
  377.  
  378.     First row   :          Second row  :            Third row   :  
  379.     Esc         : 1        ` ~         : 41         Tab         : 15    
  380.     F1          : 59       1 !         : 2          q           : 16    
  381.     F2          : 60       2 @         : 3          w           : 17    
  382.     F3          : 61       3 #         : 4          e           : 18    
  383.     F4          : 62       4 $         : 5          r           : 19    
  384.     F5          : 63       5 %         : 6          t           : 20    
  385.     F6          : 64       6 ^         : 7          y           : 21    
  386.     F7          : 65       7 &         : 8          u           : 22    
  387.     F8          : 66       8 *         : 9          i           : 23    
  388.     F9          : 67       9 (         : 10         o           : 24    
  389.     F10         : 68       0 )         : 11         p           : 25    
  390.     F11         : 87       - _         : 12         [ {         : 26    
  391.     F12         : 88       = +         : 13         ] }         : 27    
  392.     Alt+PrtScr  : 84       Backspace   : 14         | \         : 43    
  393.     Scroll Lock : 70
  394.  
  395.     Fourth row  :          Fifth row   :            Numeric pad :
  396.     Caps lock   : 58       Left Shift  : 42         Num Lock    : 69   
  397.     a           : 30       z           : 44         *           : 55   
  398.     s           : 31       x           : 45         -           : 74   
  399.     d           : 32       c           : 46         +           : 78   
  400.     f           : 33       v           : 47         7 Home      : 71      
  401.     g           : 34       b           : 48         8 Up        : 72      
  402.     h           : 35       n           : 49         9 PgUp      : 73      
  403.     j           : 36       m           : 50         4 Left      : 75      
  404.     k           : 37       , <         : 51         5           : 76      
  405.     l           : 38       . >         : 52         6 Right     : 77      
  406.     ; :         : 39       / ?         : 53         1 End       : 79      
  407.     ' "         : 40       Right Shift : 54         2 Down      : 80      
  408.     Enter       : 28                                3 PgDown    : 81      
  409.                                                     0 Ins       : 82      
  410.                            Sixth row   :              Del       : 83      
  411.                            Ctrl        : 29         
  412.                            Alt         : 56                               
  413.                            Space       : 57         
  414.